home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 2 / Deutsche Edition 2.iso / mac / VIRUS / Gatekeeper 1.2.8 ƒ / Gatekeeper Introduction.txt < prev    next >
Text File  |  1993-08-17  |  37KB  |  974 lines

  1.  
  2.  
  3.  
  4. Introduction to Gatekeeper
  5.  
  6. Version 1.2.8
  7. August 1993
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14. Installing Gatekeeper
  15. ------------------------------------------------------------------
  16.  
  17.  
  18.  
  19. Gatekeeper will only operate on Macintoshes with the 128K ROMs, or
  20. better. This means that it should work fine with the Macintosh
  21. 512Ke, Plus, SE series, II series, Classic, LC and better. In
  22. addition it should only be used with System versions 4.1 or later;
  23. ideally 6.0.4 or later.
  24.  
  25.  
  26.  
  27. To install Gatekeeper youÕll need the following files: Gatekeeper,
  28. Gatekeeper Controls, and Gatekeeper Aid. Where these files are
  29. placed, however, varies depending on the version of the System you
  30. happen to be using. Regardless of the System you are using, though,
  31. you can install Gatekeeper quickly and correctly by following the
  32. steps below.
  33.  
  34. 1.  Find your System FolderÕs icon.
  35.  
  36. 2.  If the System Folder window is open (the System FolderÕs icon
  37.     will appear gray if it is), find and close that window.
  38.  
  39. 3.  Select the Gatekeeper, Gatekeeper Aid and Gatekeeper Controls
  40.     files and drag them onto your System FolderÕs icon.
  41.  
  42. 4.  If youÕre running a System earlier than version 7.0, the
  43.     files will be copied and thatÕll be that. If youÕre running 
  44.     System 7.0 or later an alert will appear and youÕll be told that 
  45.     the items Òneed to be stored in special places inside the System 
  46.     FolderӠРjust click the OK button in this alert and everything 
  47.     will happen automatically.
  48.  
  49. 5.  Double-check the installation by making sure those items are
  50.     in the locations shown in the following diagrams.
  51.  
  52. 6.  If youÕve used Gatekeeper 1.2.x on your Mac before, look for
  53.     the Gatekeeper Prefs file in either the System Folder or the
  54.     Preferences folder. If you find it, throw it away. This will 
  55.     force Gatekeeper 1.2.8 to create a new Prefs file when you 
  56.     restart your Mac. The new Prefs file will contain the latest set 
  57.     of default privilege information, so it is normally preferable 
  58.     to earlier versions of the file.
  59.  
  60.  
  61. System 4.1 to System 6.0.x Gatekeeper Component Locations
  62.  
  63. [Graphic Omitted]
  64.  
  65.  
  66. System 7.x Gatekeeper Component Locations
  67.  
  68. [Graphic Omitted]
  69.  
  70.  
  71. NOTE: Once Gatekeeper is installed and operating it will create two
  72. new files named ÒGatekeeper LogÓ and ÒGatekeeper PrefsÓ. System 7
  73. users will find these files in the Preferences folder, while users
  74. of earlier systems will find them in the System Folder.
  75.  
  76. Because of the way Gatekeeper Controls was written, you are not
  77. required to place it in the Control Panels folder under System 7.
  78. In fact, you can put it anywhere that happens to be convenient, or
  79. you can even remove it altogether if you are certain you wonÕt need
  80. it to configure Gatekeeper at some later date. In general though,
  81. itÕs best to put it in the Control Panels folder and leave it
  82. there, so that there wonÕt be any question of where to find it when
  83. you need it.
  84.  
  85. System 6 users do not have the option of relocating the Gatekeeper
  86. Controls file; it must be located in the System Folder for the
  87. Control Panel desk accessory to find it. However, it is possible to
  88. omit the Gatekeeper Controls file, if you are certain you wonÕt
  89. need it to configure Gatekeeper at some later date. Omitting
  90. Gatekeeper Controls is useful when youÕre setting up a facility
  91. like a public access lab in which you donÕt want users changing
  92. GatekeeperÕs configuration.
  93.  
  94. For the sake of flexibility there are three valid locations for the
  95. Gatekeeper Log and Gatekeeper Prefs files under System 7. They can
  96. be in the Preferences folder, the System Folder, or the same folder
  97. that contains Gatekeeper. Under System 6, however, the choice of
  98. location is limited to the System Folder or the same folder that
  99. contains Gatekeeper (there are a few INITs which make this
  100. distinction relevant).
  101.  
  102. NOTE: If, after you install Gatekeeper, you do not see the new
  103. Gatekeeper icons (particularly the color icons available under
  104. System 7) you will need to delete all previous versions of
  105. Gatekeeper from your disk(s) and rebuild your Desktop file. This is
  106. done by restarting your Macintosh while holding down both the
  107. command and option keys until menus reappear in the menu bar at the
  108. top of the screen. At this time you can release those keys. You
  109. will soon be asked if you want to Òrebuild the desktopÓ on your
  110. disk(s). Click on the OK button, and the Finder will do the rest
  111. for you. Remember, however, that rebuilding your Desktop file will
  112. remove all the comments attached to your files in the ÒGet InfoÉÓ
  113. dialog Ð other than that, though, itÕs a harmless operation.
  114.  
  115.  
  116.  
  117.  
  118.  
  119. Gatekeeper in Principle
  120. ------------------------------------------------------------------
  121.  
  122.  
  123.  
  124. Gatekeeper is a program designed to continuously monitor the
  125. operation of your Macintosh, watching for operations that are
  126. commonly carried out by viruses as they attempt to spread. When
  127. Gatekeeper detects an infection attempt it will automatically stop
  128. the attempt, almost before itÕs started.
  129.  
  130. This type of monitoring and protection is possible because viruses
  131. generally depend on a small group of operations which they use in
  132. somewhat unusual ways. Of course, if detecting virus operations was
  133. really as straightforward as all that, everyone would be doing it.
  134. The fact is thereÕs a catch. Not a big one, but a catch just the
  135. same:
  136.  
  137. Some perfectly normal programs carry out some of the same basic
  138. operations that viruses do. (For very different reasons, of course.)
  139.  
  140. Gatekeeper deals with these Òfalse-alarmsÓ by allowing you to tell
  141. it what virus-like operations any given program should be allowed
  142. to carry out. You tell Gatekeeper just once, then forget about it Ð
  143. everythingÕs automatic from then on.
  144.  
  145. Gatekeeper restricts two basic classes of operations:
  146.  
  147. 1.  Operations on information about files that contain programs.
  148.     These are known as ÒFileÓ operations.
  149.     
  150. 2.  Operations on the components of programs stored within files. 
  151.     These are known as ÒResourceÓ (usually abbreviated as just 
  152.     ÒResÓ) operations.
  153.  
  154. Within each class of operation there are three variants:
  155.  
  156. 1.    The file being operated on is the file containing the currently 
  157.     running program, i.e. the program is operating on itself. This 
  158.     is known as an operation of type ÒSelf.Ó
  159.     
  160. 2.    The file being operated on is the System file. This is known
  161.     as an operation of type ÒSystemÓ (usually abbreviated as ÒSysÓ).
  162.     
  163. 3.    The file being operated on is some other file, i.e. the program 
  164.     isnÕt operating on itself (case 1) and it isnÕt operating on the 
  165.     System file (case 2), either. This is known as an operation of 
  166.     type ÒOther.Ó
  167.  
  168. With these two basic classes of virus operations, each of which has
  169. three variants, we get a total of six separate operations for which
  170. Gatekeeper has to watch.
  171.  
  172. If this doesnÕt mean anything to you, donÕt worry. ItÕs helpful to
  173. understand what these different operations do, but itÕs certainly
  174. not required. Just understand that there are two classes of
  175. operations monitored by Gatekeeper, ÒFileÓ and ÒRes,Ó and that
  176. there are just three variations within those two classes, ÒSelf,Ó
  177. ÒSystemÓ and ÒOther.Ó You donÕt have to memorize this, but itÕs
  178. worth being aware of it.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185. Gatekeeper in Practice
  186. ------------------------------------------------------------------
  187.  
  188. 
  189.  
  190. [Graphic Omitted]
  191.  
  192. When push comes to shove, this is what Gatekeeper does. It
  193. automatically detects and stops suspicious operations and notifies
  194. you of the event.
  195.  
  196. This alert tells you what program appears to have been responsible
  197. for the suspicious operation (Kermit), what privilege the program
  198. attempted to violate (Res(System)), and who the intended victim was
  199. (the System file). For the technical and the curious, it also
  200. includes in brackets the name of the actual Toolbox or OS operation
  201. that was blocked (AddResource) and what itÕs immediate intent was
  202. (to add a resource of type ÔnVIRÕ with an ID number of 0 to the
  203. System file).
  204.  
  205. In this case the operation being stopped was an attempt by the nVIR
  206. virus to implant itself in a MacintoshÕs System file. But what if
  207. you didnÕt know about the nVIR virus? How would you determine
  208. whether or not this was an operation that should have been
  209. permitted?
  210.  
  211. Unfortunately, thereÕs no perfect method. The first thing to do is
  212. to run John NorstadÕs Disinfectant utility, version 3.2 or later,
  213. to check for known viruses. If Disinfectant gives your Mac a clean
  214. bill of health, youÕre probably safe. If youÕre still not sure
  215. whether or not that operation should have been permitted, there are
  216. a few rules of thumb that take care of most situations, so, when in
  217. doubt, ask yourself the following questions:
  218.  
  219. Does the program modify, create, install, decode, recover or
  220. restore applications, extensions or control panels? If so, itÕll
  221. need some type of File privilege.
  222.  
  223. ¥   All file manipulation, backup and recovery software will
  224.     require File(Other) privileges in order to work properly.
  225.  
  226.     Examples: Finder, DiskFit, Symantec Tools, HFS Recover, 
  227.     MacTools, Scanner, Floppy Recover, HD TuneUp, File Splitter.
  228.  
  229. ¥   Communications programs, compression utilities, and electronic
  230.     mail packages require File(Other) privileges when decoding
  231.     downloaded applications and system files.
  232.  
  233.     Examples: Compact Pro, StuffIt, PackIt, BinHex, NCSA Telnet,
  234.     XferIt, VersaTerm, MacTerminal, White Knight, AppleLink, etc.
  235.  
  236. NOTE: Gatekeeper does not require that self extracting archives
  237. (SEAs) created by Compact Pro, StuffIt, Zoom or Disk Doubler have
  238. any privileges in order to operate. These types of SEAs are handled
  239. as special cases internally, so they can be used without privileges
  240. and without worry.
  241.  
  242. Does the program modify, create, install or delete resources that
  243. contain programs? If so, itÕll need some type of Res privilege.
  244. Some of the most common examples of resources that contain programs
  245. are desk accessories, FKEYs, and HyperCardÕs XCMDs and XFCNs.
  246.  
  247. ¥   Installer and Updater applications almost always require
  248.     Res(Other) and/or Res(System) privileges and are likely to 
  249.     require similar File privileges. However, since these applica-
  250.     tions are used infrequently, they shouldnÕt be granted any 
  251.     privileges. Just turn Gatekeeper off (after using Disinfectant 
  252.     2.9, or later, to verify that the items to be installed are 
  253.     free of known viruses) while you perform the installation.
  254.  
  255.     Examples: AppleÕs Installer, PageMaker Installer, TOPS Installer.
  256.  
  257. ¥   Resource manipulation utilities generally need Res(Other)
  258.     privileges and will need Res(System) privileges if they are used 
  259.     to modify the System file. The exact privileges they require 
  260.     will depend on what you use these utilities for.
  261.  
  262.     Examples: Font/DA Mover, ResEdit, FKey Manager, ResCopier stack,
  263.     RMaker, Rez.
  264.  
  265. ¥   Development systems (i.e. programming languages) require
  266.     File(Other) and Res(Other) privileges in order to build 
  267.     virtually all projects.
  268.  
  269.     Examples: THINK C, THINK Pascal and AppleÕs MPW.
  270.  
  271. If none of these cases seem to fit your situation, or youÕre just
  272. not sure, check with others who might have relevant knowledge Ð
  273. users groups can be good places to find such people.
  274.  
  275. If none of the programs listed in the examples above sound very
  276. familiar to you, donÕt worry: most programs donÕt need any
  277. privileges.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284. GatekeeperÕs Division of Labor
  285. ------------------------------------------------------------------
  286.  
  287.  
  288.  
  289. There are two crucial components of any Gatekeeper installation;
  290. Gatekeeper and Gatekeeper Aid. Although this document will discuss
  291. Gatekeeper at length, it will hardly mention Gatekeeper Aid,
  292. because it doesnÕt require any configuration. In this section,
  293. though, weÕll take some time out to talk a bit about Gatekeeper Aid
  294. and how it relates to Gatekeeper.
  295.  
  296. Gatekeeper, as has been discussed above, is a general purpose
  297. anti-virus utility which knows little or nothing about specific
  298. viruses. It stops viruses from operating by carefully monitoring
  299. your Mac and stopping any suspicious behavior that occurs. It has
  300. been remarkably successful in stopping both the viruses that
  301. existed when it was first released and those that have appeared in
  302. the years since then, but no anti-virus system can ever be perfect,
  303. and at least one virus appeared that could get around GatekeeperÕs
  304. protections. ThatÕs why Gatekeeper Aid exists.
  305.  
  306. Gatekeeper Aid is a utility that searches for and removes families
  307. of known viruses which Gatekeeper either canÕt stop at all, or
  308. canÕt stop completely enough to render harmless. Over time, its
  309. role has been expanded to include some general purpose anti-virus
  310. duties as well as the detection and removal of some viruses that
  311. Gatekeeper can stop successfully, but which also happen to be
  312. easily detected and removed.
  313.  
  314. Together, Gatekeeper and Gatekeeper Aid form a security system
  315. capable of stopping all known viruses, and one with a proven (if
  316. inevitably imperfect) ability to stop new viruses as they appear.
  317. This is why itÕs crucial to use both products; one or the other
  318. isnÕt enough to provide effective protection.
  319.  
  320. In spite of this, it is possible to use Gatekeeper Aid independent
  321. of Gatekeeper. Some people use Gatekeeper Aid to augment the
  322. abilities of other anti-virus utilities, like the Disinfectant
  323. INIT. Rest assured that ÕAid still works perfectly well in such
  324. setups.
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331. 1 Ð General Section
  332. ------------------------------------------------------------------
  333.  
  334.  
  335.  
  336. [Graphic Omitted]
  337.  
  338. GatekeeperÕs General section is always the first thing youÕll see
  339. when you open Gatekeeper. ItÕll tell you what version of Gatekeeper
  340. youÕre using, but other than that itÕs pretty dull. 
  341.  
  342. The most important thing in this section isnÕt really a part of
  343. this section at all; itÕs the scrolling list of sections which
  344. always appears in the same place at the top of the window. This
  345. list shows you all the other parts of Gatekeeper you can access.
  346. Clicking on a section name in the list takes you to that section.
  347.  
  348.  
  349.     Keyboard Shortcuts Ð Section List
  350.     -------------------------------------------------------
  351.     tab                 Advance to next section.
  352.     shift + tab         Go back to previous section.
  353.     -------------------------------------------------------
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360. 2 ÐÊHelp Section
  361. ------------------------------------------------------------------
  362.  
  363.  
  364.  
  365. [Graphic Omitted]
  366.  
  367. The Help section provides a simple quick-reference to GatekeeperÕs
  368. features. It doesnÕt do anything fancy; IÕm afraid thereÕs no
  369. searching or indexing features. However, when used on Macs running
  370. System 6.0 or later, the text is displayed in multiple fonts, sizes
  371. and styles to make the text as easy to navigate as possible. In
  372. particular, major section headings in the help text are set in
  373. Helvetica 18 point bold, so theyÕre easily located as you scroll
  374. through the text.
  375.  
  376. To view the text properly, make sure that the Times, Helvetica and
  377. Monaco fonts are installed in your System.
  378.  
  379. If youÕd like to print text from the help display, select the text
  380. with the mouse and then select the ÒCopyÓ item from the ÒEditÓ
  381. menu. You can then paste the text into any word processor and print
  382. it out in any way youÕd like.
  383.  
  384.  
  385.     Keyboard Shortcuts
  386.     -------------------------------------------------------
  387.     home                Move to top of help text.
  388.     end                 Move to bottom of help text.
  389.     page up             Move up one Òpage.Ó
  390.     page down           Move down one Òpage.Ó
  391.     option              If held down when the Help section 
  392.                         is initially opened, help text is 
  393.                         displayed only in Geneva 9.
  394.     -------------------------------------------------------
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401. 3 Ð ON/OFF Section
  402. ------------------------------------------------------------------
  403.  
  404.  
  405.  
  406. [Graphic Omitted]
  407.  
  408. The ON/OFF section provides you with the means to turn off
  409. Gatekeeper for up to nearly one hundred hours. ItÕs simple enough;
  410. just click on the big, fancy ON/OFF button. When the button says
  411. OFF in big, bold, red letters, all of GatekeeperÕs protections are
  412. disabled. When the button merely says ON, Gatekeeper is operating
  413. normally, providing your system all the protection it can.
  414.  
  415. Turn Gatekeeper off when youÕre performing relatively brief tasks
  416. that Gatekeeper would otherwise interfere with. The most common
  417. examples of such tasks are running ÒinstallerÓ programs which
  418. install software of some kind on your system, such as PageMaker or
  419. TOPS.
  420.  
  421. Remember, Gatekeeper will automatically turn itself on again after
  422. the time limit has expired. (If youÕre looking at the ON/OFF
  423. section at the time, youÕll see that the time remaining counter has
  424. counted-down to 0:00:00.) If the time limit value is too small (or
  425. too large) for your needs, you can change it just by clicking on it
  426. and entering the new value the same way you would if you were
  427. setting the time in the General control panel or the Alarm Clock
  428. desk accessory.
  429.  
  430. NOTE: Turning off Gatekeeper doesnÕt turn off Gatekeeper Aid. Even
  431. with Gatekeeper off, ÕAid will still remove any known viruses that
  432. it detects. The one thing it will not do is remove suspicious
  433. resources (known as ÒImplied LoadersÓ) when it comes across them.
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440. 4 Ð Settings Section
  441. ------------------------------------------------------------------
  442.  
  443.  
  444.  
  445. [Graphic Omitted]
  446.  
  447. The Settings section allows you to define some of the basic ways in
  448. which Gatekeeper operates. Each group of options is discussed
  449. below.
  450.  
  451. When a Privilege Violation Occurs
  452. ---------------------------------
  453.  
  454. Two radio buttons in this area let you tell Gatekeeper what to do
  455. about suspicious operations it encounters. When the ÒStop the
  456. Operation (Notify & Veto)Ó radio button is selected, Gatekeeper
  457. will stop any suspicious activities it observes. On the other hand,
  458. if the ÒPermit the Operation (Notify Only)Ó radio button is
  459. selected, Gatekeeper will not actually interfere with suspicious
  460. operations; it will merely tell you the operations have occurred.
  461. ItÕs then up to you what you do about them.
  462.  
  463. Gatekeeper Aid will also respect these settings to some extent Ð
  464. when ÒNotify OnlyÓ mode is chosen, it will refrain from removing
  465. any suspicious resources (known as ÒImplied LoadersÓ) that it may
  466. find. However, even in ÒNotify OnlyÓ mode, ÕAid will still remove
  467. any known viruses it comes across.
  468.  
  469. When an Important Event Occurs
  470. ------------------------------
  471.  
  472. Two check boxes in this area let you tell Gatekeeper and Gatekeeper
  473. Aid what they should do when they need to get your attention.
  474. Typically, they only need to get your attention when they observe
  475. things like privilege violations, viral infections or other
  476. similarly unusual events. The ÒDisplay an AlertÓ check box tells
  477. Gatekeeper and ÕAid, when they are used with System 6.0 or later,
  478. to display an alert describing the event that occurred and their
  479. response to that event. The ÒRecord it in the Log FileÓ check box
  480. tells them to record a short description of the event in the
  481. Gatekeeper Log file for later review. These two options may be in
  482. used in any combination you find convenient; in practice, however,
  483. itÕs best to keep both options checked.
  484.  
  485. During Startup
  486. --------------
  487.  
  488. Two check boxes in this area let you tell Gatekeeper and ÕAid how
  489. to behave when your Mac starts-up. If the ÒShow the Gatekeeper
  490. IconÓ check box is checked, Gatekeeper and Gatekeeper AidÕs icons
  491. will be displayed somewhere along the bottom of your MacÕs display
  492. during startup. Showing icons in this fashion is merely a
  493. convenient way of showing that both items are installed on your
  494. Macintosh. In addition, if either one cannot install itself for
  495. some reason, its icon will be drawn with a large red X over it to
  496. warn you that something went wrong.
  497.  
  498. The other check box in this area, labeled ÒDisplay a Mode Warning
  499. AlertÓ, allows you to tell Gatekeeper whether or not it should
  500. display a ÒwarningÓ alert after startup to remind you of what mode
  501. it is operating in. Gatekeeper can operate in either Notify Only or
  502. Notify & Veto mode. By default, Gatekeeper displays a warning alert
  503. after startup when it is in Notify Only mode (since it doesnÕt
  504. protect against viruses in that mode), but does not display a
  505. warning alert when in Notify & Veto mode (since that is the mode in
  506. which Gatekeeper normally operates). The ÒDisplay a Mode Warning
  507. AlertÓ check box, however, allows you to change this behavior to
  508. suit your own needs.
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515. 5 ÐÊLog Section
  516. ------------------------------------------------------------------
  517.  
  518.  
  519.  
  520. [Graphic Omitted]
  521.  
  522. The Log section allows you to view the contents of GatekeeperÕs log
  523. file if the ÒRecord it in the Log FileÓ option is checked in the
  524. Settings section. The log is a file in which Gatekeeper and
  525. Gatekeeper Aid record all the important events they observe so that
  526. you can review them at a later date.
  527.  
  528. Each entry in the log file occupies one line of the log display.
  529. Entries for different days are separated by a line which indicates
  530. the day and date on which the entries below it occurred. All other
  531. lines in the display begin with the time at which the event
  532. occurred and are completed by a brief indication of the type of
  533. event that occurred. Important events like privilege violations are
  534. drawn in bold, red text so that you can locate them at a glance.
  535. Startup and Shutdown messages are grouped together by dotted lines
  536. in the left margin of the list so that you easily see when your Mac
  537. has been in use, or has crashed.
  538.  
  539. To see an explanation of an entry in the log file, select that
  540. entry in the log file display and click on the ÒGet InfoÓ button. A
  541. dialog similar to one of the two on the next page will appear. The
  542. dialog will give you all the available details including the name
  543. of the program responsible for the operation and the name of the
  544. disk that program was stored on at the time.
  545.  
  546. Double-clicking on an entry, not surprisingly, has the same effect
  547. as selecting an entry and clicking on the ÒGet InfoÓ button.
  548.  
  549. [Graphic Omitted]
  550.  
  551. Startup & Shutdown Entries
  552. --------------------------
  553.  
  554. Normally, the log will contain only ÒStartupÓ and ÒShutdownÓ
  555. entries, which tell you when your Macintosh has been started or
  556. shutdown in GatekeeperÕs presence. These entries are totally
  557. routine, and are recorded only to help you determine when your Mac
  558. has been used and whether it may have been used without Gatekeeper,
  559. thereby leaving it unprotected against possible virus attacks.
  560.  
  561. HINT: To determine whether your Mac may have been used without
  562. Gatekeeper, look at the difference between the volume write counts
  563. for a Shutdown entry and the Startup entry that appears immediately
  564. after it. If the difference is greater than normal Ð and itÕs up to
  565. you to determine whatÕs normal for your Mac Ð then your Mac
  566. probably has been booted with some other disk. So whatÕs a Òvolume
  567. write countÓ? ItÕs just the number of times any information has
  568. been written to the disk since it was last initialized. Every time
  569. you save a document, for instance, a number of writes are made to
  570. the disk and the volume write count increases accordingly.
  571.  
  572. Res & File Privilege Violation Entries
  573. --------------------------------------
  574.  
  575. Occasionally, you may find other entries in the log file, though.
  576. These entries begin with the words ÒResÓ or ÒFileÓ and describe
  577. attempts by programs to exceed the privileges they have been
  578. granted. These entries tell you one of two things: (1) some program
  579. needs additional privileges in order to operate correctly, or (2) a
  580. virus is attempting to spread on your Macintosh and is being
  581. stopped by Gatekeeper. If youÕre not sure which is which, run
  582. Disinfectant 3.2, or later, to see if there are any known viruses
  583. on your Macintosh. If Disinfectant detects a virus in the program
  584. that was guilty of the privilege violation, you know that
  585. Gatekeeper was doing its job properly and stopping a virus from
  586. spreading. If Disinfectant gives your Mac a clean bill of health,
  587. though, itÕs up to you to determine whether the guilty program was
  588. operating normally, or was the victim of a new virus which
  589. Disinfectant cannot detect.
  590.  
  591. Some rules of thumb that may help you determine what privileges
  592. certain types of programs will require are included in the
  593. ÒGatekeeper in PracticeÓ section of this document. Read through
  594. those rules of thumb and see if any obvious explanations present
  595. themselves.
  596.  
  597. If youÕre still not sure what to do at this point Ð and thatÕs
  598. highly understandable Ð contact your system administrator for help.
  599. If you donÕt have a system administrator to pick on, or you are a
  600. system administrator and you still canÕt decide how to resolve the
  601. matter, make sure youÕre using the latest version of Disinfectant
  602. and remember that you can always pick on me (the author) Ð see the
  603. Bug Reports section of this document for details.
  604.  
  605. Granting Privileges from the ÒGet InfoÓ Window
  606. ----------------------------------------------
  607.  
  608. If, on the other hand, you are confident that an entry in the log
  609. file merely indicates that a program needs an additional privilege
  610. in order to operate correctly, you can easily grant that privilege
  611. to the program by clicking on the ÒGrant PrivilegeÓ button in the
  612. ÒGet InfoÓ dialog box for that entry. 
  613.  
  614. After using the Grant Privilege button, you can, if you wish,
  615. switch to the Privileges section where youÕll find that the guilty
  616. program has been automatically selected, and its privileges
  617. displayed, in case you want to make any adjustments (like removing
  618. the version number from the end of the programÕs name).
  619.  
  620. Other Entries
  621. -------------
  622.  
  623. A number of other types of entries which are not discussed here may
  624. also be found in the Gatekeeper Log. Selecting them and clicking on
  625. the ÒGet InfoÓ button will give you a brief, and hopefully
  626. informative, explanation of their meanings.
  627.  
  628.  
  629.     Keyboard Shortcuts
  630.     -------------------------------------------------------
  631.     home                Move to top of log file.
  632.     end                 Move to bottom of log file.
  633.     page up             Move up one Òpage.Ó
  634.     page down           Move down one Òpage.Ó
  635.     up-arrow            Select the previous line.
  636.     down-arrow          Select the next line.
  637.     return              Display an explanation of the 
  638.                         selected line. Same as clicking on 
  639.                         the ÒGet InfoÓ button.
  640.     enter               Same as return.
  641.     -------------------------------------------------------
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648. 6 Ð Privileges Section
  649. ------------------------------------------------------------------
  650.  
  651.  
  652.  
  653. [Graphic Omitted]
  654.  
  655. The Privilege section is the most important part of Gatekeeper. In
  656. this section you tell Gatekeeper what programs are allowed to
  657. perform operations that would otherwise be considered suspiciously
  658. virus-like. (These operations are known as Òprivileged
  659. operationsÓ.) This information allows Gatekeeper to operate
  660. automatically on behalf of you and others; preventing viruses from
  661. operating successfully while permitting normal programs to work
  662. unhindered. 
  663.  
  664. Gatekeeper is distributed with a large list of common programs
  665. known to require privileges, so that most users will not need to
  666. worry about setting-up any privileges in order to use Gatekeeper on
  667. their Macintosh system.
  668.  
  669. In order to add a program to the privilege list, you can click on
  670. the ÒAddÉÓ button and select the program using the standard ÒOpenÉÓ
  671. dialog box. Alternately, you can click on the ÒNewÉÓ button and
  672. type in the name of the program directly Ð note that this is often
  673. the only way to grant privileges to desk accessories.
  674.  
  675. In order to grant privileges to a program, click on the programÕs
  676. name in the privilege list and check the appropriate check-boxes
  677. that will appear at the bottom right side of the Privileges
  678. section. For an explanation of what the various privileges mean,
  679. see the ÒGatekeeper in PrincipleÓ section of this document.
  680.  
  681. To changed the name of an item in the privilege list, select the
  682. item and click on the ÒEditÉÓ button. A dialog box will appear in
  683. which you can edit the itemÕs name.
  684.  
  685. Removing an item from the privilege list is easiest of all; just
  686. select the item and click on the ÒClearÓ button.
  687.  
  688. To keep confusion to a minimum certain changes are made to names as
  689. they are added to the privilege list, so donÕt be surprised if the
  690. name you enter isnÕt exactly the name that actually ends-up in the
  691. privilege list. Invisible characters like control characters are
  692. replaced with spaces. So are colons. Non-breaking spaces are
  693. replaced with conventional spaces. Spaces found at the beginning of
  694. names are always removed, and diacritical marks although they are
  695. preserved, are ignored when the list is searched. These
  696. translations make Gatekeeper good at coping with subtle changes to
  697. program names, and eliminates confusion like that which resulted
  698. when Apple quietly replaced the non-breaking space in DA HandlerÕs
  699. name with a conventional space.
  700.  
  701.  
  702.     Keyboard Shortcuts
  703.     -------------------------------------------------------
  704.     home                Move to top of privilege list.
  705.     end                 Move to bottom of privilege list.
  706.     page up             Move up one Òpage.Ó
  707.     page down           Move down one Òpage.Ó
  708.     up-arrow            Select the previous line.
  709.     down-arrow          Select the next line. 
  710.     type-to-select      Typing a name will select the item 
  711.                         most closely matching that name.
  712.     return              Edit the selected item. Same as 
  713.                         clicking on the ÒEditÉÓ button.
  714.     enter               Same as return.
  715.     command + e         Same as return. 
  716.     delete              Delete the selected item. Same as 
  717.                         clicking on the ÒClearÓ button.
  718.     backspace           Same as delete.
  719.     clear               Same as delete.
  720.     command + n         Create a new entry. Same as 
  721.                         clicking on the ÒNewÉÓ button. 
  722.     command + a         Add a new entry. Same as clicking 
  723.                         on the ÒAddÉÓ button. 
  724.     command + o         Same as command + a. 
  725.     -------------------------------------------------------
  726.      System 7.0 does not allow control panels like 
  727.     Gatekeeper Controls to receive most command key 
  728.     shortcuts. Consequently, marked shortcuts do not work 
  729.     in System 7.0 Ð this is not a bug in Gatekeeper.
  730.     -------------------------------------------------------
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737. Postcards, Bug Reports, Etc.
  738. ------------------------------------------------------------------
  739.  
  740.  
  741.  
  742. I can be reached with questions, suggestions, bug reports (be sure
  743. to note the version number of Gatekeeper and/or Gatekeeper Aid that
  744. you were using), etc. atÉ
  745.  
  746. US Mail:
  747. --------
  748. Chris Johnson
  749. Gatekeeper
  750. 4505-B Avenue H
  751. Austin, TX 78751
  752. USA
  753.  
  754. Internet:
  755. ---------
  756. chrisj@emx.cc.utexas.edu
  757.  
  758. UUCP:
  759. -----
  760. {husc6|uunet}!cs.utexas.edu!ut-emx!chrisj
  761.  
  762. AppleLink:
  763. ----------
  764. chrisj@emx.cc.utexas.edu@internet#
  765.  
  766. CompuServe:
  767. -----------
  768. >INTERNET:chrisj@emx.cc.utexas.edu
  769.  
  770. MCI Mail:
  771. ---------
  772. Command: Create
  773. To: Chris Johnson (EMS)
  774. EMS: Internet
  775. MBX: chrisj@emx.cc.utexas.edu
  776.  
  777. Turnaround time on email messages is usually under 48 hours, if IÕm
  778. not drowning in mail at the time. If I am drowning in mail at the
  779. time (an increasingly common situation in the last few years),
  780. itÕll definitely take longer to get back to you. Turnaround time on
  781. US Mail is approaching five years in many cases. So, if you have
  782. the choice, send email. If you must use US Mail, including a self
  783. addressed stamped envelope just might help to speed up the process.
  784.  
  785. Éand please send a postcard. (See the Copyright Notice below.)
  786.  
  787. (Of course, if you use this product and happen to work for Apple
  788. Computer, feel free to convince Apple to contribute a fast
  789. Macintosh computer system of some sort as a way of finally showing
  790. some support for this development effort. ...Not that IÕm holding
  791. my breath.)
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798. Finding the Latest Version
  799. ------------------------------------------------------------------
  800.  
  801.  
  802.  
  803. There are several good ways to find the latest version of
  804. Gatekeeper:
  805.  
  806. 1. People with FTP access to the Internet can retrieve the latest
  807. version via anonymous FTP to the microlib/mac/virus directory of
  808. microlib.cc.utexas.edu. Of course, there are many other good
  809. archive sites which should also have current versions at any given
  810. time, but I upload new releases directly into microlib as soon as
  811. theyÕre ready, so I can guarantee that itÕs up to date.
  812.  
  813. 2. If you can send me email, I can usually email the latest version
  814. back to you. Be sure to let me know what version you are currently
  815. using. There can be problems, however. Some services like AppleLink
  816. and CompuServe limit the length of messages their users can receive
  817. to something in the neighborhood of 32K. This means that IÕd have
  818. to split Gatekeeper into more than 12 parts in order to send it via
  819. email (and the recipient would subsequently have to reassemble all
  820. those parts). This is very time consuming, so unless your mail
  821. system will accept messages close to 100K in length, itÕs probably
  822. not a good idea to try to get Gatekeeper via email. Remember to
  823. tell me the maximum message length your system will accept.
  824.  
  825. 3. U.S. Mail is also an option. Send a diskette along with a
  826. self-addressed, stamped envelope (SASE) to the address below.
  827. Unlike correspondence, I am able to periodically catch-up on all
  828. the outstanding update requests, so you really will get your disk
  829. back eventually. Unfortunately, disks sent without a SASE (or a
  830. reasonable facsimile), legible return address, correct postage,
  831. etc. canÕt be returned. I will occasionally replace a bad or
  832. damaged diskette out of my own pocket, but donÕt count on it. In
  833. other words, donÕt send me that old diskette that you found under
  834. the refrigerator last spring. I probably wonÕt be able to format it
  835. successfully, and youÕll always wonder why you didnÕt get your disk
  836. back.
  837.  
  838. Anyway, the address to send those disks to is:
  839.  
  840.         Chris Johnson
  841.         Gatekeeper Update from 1.2.8
  842.         4505-B Avenue H
  843.         Austin, TX  78751
  844.         USA
  845.  
  846. The ÒGatekeeper UpdateÉÓ line is important, so be sure to
  847. include it. Note that the Òfrom 1.2.8Ó part tells me what version
  848. you are currently using so that I wonÕt make the mistake of sending
  849. you a version which you already have.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856. Credits
  857. ------------------------------------------------------------------
  858.  
  859.  
  860.  
  861. Many thanks to all the Gatekeeper testers. Without their help and
  862. patience Gatekeeper couldnÕt have been made even remotely as
  863. reliable and trouble-free as it is.
  864.  
  865.  
  866. Scott R. Anderson
  867. Dale M. Arends
  868. Brian Aslakson
  869. Steve Baumgarten
  870. David A. Belsley
  871. Sunil Bhatla
  872. Thomas R. Blake
  873. James Blieden
  874. Jonathan Brecher
  875. Daniel Buchan
  876. Rick Cardona
  877. Ian Chai
  878. Philippe Chatalic
  879. Brian L. Donnell
  880. Jon Duke
  881. Jim Elliott
  882. Bill Engels
  883. Zbigniew Fiedorowicz
  884. Charette Frederick
  885. Brian Gaines
  886. Peter Galko
  887. David A. Grayson
  888. Ben Goren
  889. Marcus Harvey
  890. Jay Hirsh
  891. Steve Holden
  892. Kirk Holub
  893. Dan Hugo
  894. John Im
  895. David Inman
  896. William G. Innanen
  897. Andrew E. Johnson
  898. Vahe Kassardjian
  899. Kendrick Killian
  900. Edgar Knapp
  901. Dick Kriss
  902. Dave Lee
  903. Masato Ogawa
  904. Doc O'Leary
  905. John Owens
  906. John F. Pane
  907. Peter John Roberts
  908. Clay C. Ross
  909. Nick Rothwell
  910. Robert Rubinoff
  911. Howard Shubs
  912. Larry Simmons
  913. Robert Stewart
  914. Michael Stovsky
  915. Jochen Teufel
  916. Werner Uhrig
  917. Johan van Zanten
  918. Mike Weasner
  919. Jerry Wilcox
  920. Thomas Willett
  921. Ed Wright
  922. Marvin Yount
  923. David R. Zinkin
  924. Sam Zschokke
  925.  
  926.  
  927. I would also like to thank all the people around the world who have
  928. sent me problem reports at one time or another. Unfortunately,
  929. thereÕs just no testing ground quite like the real world. There are
  930. too many people to list (and, in fact, too many to keep track of),
  931. but they know who they are. Thanks to all.
  932.  
  933. Thanks to Ken McLeod for his translation of the original ShowINIT
  934. code into THINK C. ThereÕs only a few lines of his code left in
  935. GatekeeperÕs ShowINIT implementation, but IÕm glad I had that code
  936. to work from. Patrick C. BeardÕs code was also helpful, but none of
  937. it survives into this implementation.
  938.  
  939. Gatekeeper and Gatekeeper Aid were built with version 5.0.4 of
  940. THINK C.
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947. Copyright ©
  948. ------------------------------------------------------------------
  949.  
  950.  
  951.  
  952. Gatekeeper ©1988-1993
  953. Gatekeeper Aid ©1990-1993
  954. by Chris Johnson.
  955.  
  956. All Rights Reserved.
  957.  
  958. Gatekeeper and Gatekeeper Aid are free for non commercial public
  959. distribution. This software may not be sold or distributed for
  960. profit, or included with other software or hardware which is sold
  961. or distributed for profit, without the permission of the author.
  962. (CD-ROM publishers are not now, nor have they ever been, an
  963. exception to this rule.)
  964.  
  965. To put it simply, I donÕt make any money from this software, so
  966. nobody else should either.
  967.  
  968. While there is no charge for Gatekeeper, I do ask that if you use
  969. this product, you send me a picture postcard from your home town
  970. (or from wherever you happen to be at the time). If thatÕs too much
  971. to ask, find a comparable product with more reasonable terms....
  972.  
  973.  
  974.